
<html><HEAD>
<LINK REL=STYLESHEET HREF="default.css" TYPE="text/css">
<TITLE>
DDE functions and events </TITLE>
</HEAD>
<BODY>

<!-- Header -->
<p class="ancestor" align="right"><A HREF="apptechp109.htm">Previous</A>&nbsp;&nbsp;<A HREF="apptechp111.htm" >Next</A>
<!-- End Header -->
<A NAME="CHDCHDHC"></A><h1>DDE functions and events </h1>
<A NAME="TI3007"></A><p>The following tables list the DDE functions and events separated
into those functions and events used by DDE clients and those used
by DDE servers. For more information on DDE support, see the <i>PowerScript
Reference</i>
.</p>
<p><img src="images/note.gif" width=17 height=17 border=0 align="bottom" alt="Note"> <span class=shaded>Return values</span> <A NAME="TI3008"></A>Every DDE function returns an integer.</p>
<A NAME="TI3009"></A><h4>DDE client </h4>
<A NAME="TI3010"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 18-1: DDE client functions</caption>
<tr><th  rowspan="1"  ><A NAME="TI3011"></A>Function</th>
<th  rowspan="1"  ><A NAME="TI3012"></A>Action</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3013"></A><b>CloseChannel</b></td>
<td  rowspan="1"  ><A NAME="TI3014"></A>Closes a channel to a DDE server application
that was opened using <b>OpenChannel</b>.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3015"></A><b>ExecRemote</b></td>
<td  rowspan="1"  ><A NAME="TI3016"></A>Asks a DDE server application to execute
a command.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3017"></A><b>GetDataDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3018"></A>Obtains the new data from a hot-linked
DDE server application and moves it into a specified string.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3019"></A><b>GetDataDDEOrigin</b></td>
<td  rowspan="1"  ><A NAME="TI3020"></A>Determines the origin of data that has
arrived from a hot-linked DDE server application.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3021"></A><b>GetRemote</b></td>
<td  rowspan="1"  ><A NAME="TI3022"></A>Asks a DDE server application for data.
This function has two formats: one that uses a channel and one that
does not.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3023"></A><b>OpenChannel</b></td>
<td  rowspan="1"  ><A NAME="TI3024"></A>Opens a DDE channel to a specified DDE
server application.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3025"></A><b>RespondRemote</b></td>
<td  rowspan="1"  ><A NAME="TI3026"></A>Indicates to the DDE server application
whether the command or data received from the DDE application was acceptable
to the DDE client.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3027"></A><b>SetRemote</b></td>
<td  rowspan="1"  ><A NAME="TI3028"></A>Asks a DDE server application to set
an item such as a cell in a worksheet or a variable to a specific
value. This function has two formats: one that uses a DDE channel
and one that does not.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3029"></A><b>StartHotLink</b></td>
<td  rowspan="1"  ><A NAME="TI3030"></A>Initiates a hot link to a DDE server
application so that PowerBuilder is immediately notified of specific
data changes in the DDE server application.</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3031"></A><b>StopHotLink</b></td>
<td  rowspan="1"  ><A NAME="TI3032"></A>Ends a hot link with a DDE server application.</td>
</tr>
</table>
<A NAME="TI3033"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 18-2: DDE client event</caption>
<tr><th  rowspan="1"  ><A NAME="TI3034"></A>Event</th>
<th  rowspan="1"  ><A NAME="TI3035"></A>Occurs when</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3036"></A>HotLinkAlarm</td>
<td  rowspan="1"  ><A NAME="TI3037"></A>A DDE server application has sent new
(changed) data.</td>
</tr>
</table>
<A NAME="TI3038"></A><h4>DDE server </h4>
<A NAME="TI3039"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 18-3: DDE server functions</caption>
<tr><th  rowspan="1"  ><A NAME="TI3040"></A>Function</th>
<th  rowspan="1"  ><A NAME="TI3041"></A>Action</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3042"></A><b>GetCommandDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3043"></A>Obtains the command sent by a DDE client
application</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3044"></A><b>GetCommandDDEOrigin</b></td>
<td  rowspan="1"  ><A NAME="TI3045"></A>Determines the origin of a command from
a DDE client</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3046"></A><b>GetDataDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3047"></A>Gets data that a DDE client application
has sent and moves it into a specified string</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3048"></A><b>GetDataDDEOrigin</b></td>
<td  rowspan="1"  ><A NAME="TI3049"></A>Determines the origin of data that has
arrived from a hot-linked DDE client application</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3050"></A><b>RespondRemote</b></td>
<td  rowspan="1"  ><A NAME="TI3051"></A>Indicates to the sending DDE client application
whether the command or data received from the DDE application was
acceptable to the DDE server</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3052"></A><b>SetDataDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3053"></A>Sends specified data to a DDE client
application</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3054"></A><b>StartServerDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3055"></A>Causes a PowerBuilder application to
begin acting as a DDE server</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3056"></A><b>StopServerDDE</b></td>
<td  rowspan="1"  ><A NAME="TI3057"></A>Causes a PowerBuilder application to
stop acting as a DDE server</td>
</tr>
</table>
<A NAME="TI3058"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><caption>Table 18-4: DDE server events</caption>
<tr><th  rowspan="1"  ><A NAME="TI3059"></A>Event</th>
<th  rowspan="1"  ><A NAME="TI3060"></A>Occurs when</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3061"></A>RemoteExec</td>
<td  rowspan="1"  ><A NAME="TI3062"></A>A DDE client application has sent a command</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3063"></A>RemoteHotLinkStart</td>
<td  rowspan="1"  ><A NAME="TI3064"></A>A DDE client application wants to start
a hot link</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3065"></A>RemoteHotLinkStop</td>
<td  rowspan="1"  ><A NAME="TI3066"></A>A DDE client application wants to end
a hot link</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3067"></A>RemoteRequest</td>
<td  rowspan="1"  ><A NAME="TI3068"></A>A DDE client application has requested
data</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI3069"></A>RemoteSend</td>
<td  rowspan="1"  ><A NAME="TI3070"></A>A DDE client application has sent data</td>
</tr>
</table>

